MacSleuth 


i 


oe ES: A HARDWARE SUMMARY 


Resolution: 
Colors: 256 
Alternate: #800000 


Sample Rate 
22k 44k 


SYSTEM DIAGNOSTIC SOFTWARE 


THE ALL-IN-ONE CONFIGURATION 
AND TROUBLESHOOTING UTILITY 


* 


DARIANA TECHNOLOGY GROUP, INC. 


Q 


Vi Dariana Lescaut id ae Inc. 


Dear Dariana Technology Group Customer: 

The product you are using is a limited version. Some 
modules or features are not implemented in this release. As 
an example, System Sleuth Version 3.0 now includes full 
hardware testing facilities in addition to several powerful 
analysis features not included in the limited version. 

To receive the full benefit from your System Sleuth, Mac- 
Sleuth or WinSleuth product, you may upgrade to a full 
working version of the program. 


To receive a full working copy, send $60.00 with the front 
cover of this manual to 


Dariana Technology Group, Inc. 
6549 Hermosa circle 
Buena Park, CA 90620 


You may also call our sales department to order your 
upgrade. 


1-800-541-6579 Voice 
(714) 994-7401 Fax 
Visa/MasterCard orders accepted. 


Thank You 


Frank Westall 


Director, Dariana Technology Group, Inc. 
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MacSleuth was developed to help you under- 
stand your MacInstosh environment in more 
detail. A wealth of information is provided to 
help resolve possible system conflicts with your 
hardware, software, and installation parameters. 
The display modules in many cases show and ex- 
plain significant system parameters that may at 
times be inconsistent with each other. 


The MacSleuth user interface design allows for 
easy insertion of additional display modules to 
accomodate future hardware and software exten- 
sions to your MacIntosh environment. 


MacSleuth User’s Manual - 11 


10507050"070707070"070"07070"070707020507 070707 0507050207 0500207070200 0020000000050 oa lla tata tata eto tote afore tota fete to fe teta ofa e fe tote tates 


MacSleuth is designed to operate on any Macin- 
tosh computer running System Version 6.0.2 or 
higher. At least one megabyte of RAM memory 
is advisable although no o caaaty memory require- 
ment exists. 


MacSleuth is fully compatible with MultiFinder 
operation. In fact, use under the MultiFinder is 
encouraged since MacSleuth may then be able to 
explore side effects — by multitasking 
various applications. 
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There are no special requirements for installing 
MacSleuth. Simply drag the MacSleuth icon 

| onto the volume of your choice. If you wish to in- 

, _ Clude the on-line help facilities, copy the Help- 

| Screens also. It is recommended that you store 
the original MacSleuth disk in a safe place in the 
event in the event a re-installation may be re- 
quired. 
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MacSleuth is launched by double-clicking the 
MacSleuth icon. The following main screen will 
appear: 


ao eae MacSleuth —_—— 


Interface Guidelines 

Please note that the MacSleuth user interface 
strongly resembles that of the Macintosh Control 
Panel Desk Accessory. The vertically aligned dis- 
play module icons on the left indicate informa- 
tion display categories available with this 
MacSleuth version. A display category is simply 
an identifyable Macintosh hardware or software 
feature of interest. Each display icon has a 
descriptive title below. The elevator control al- 
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lows for rapid movement to various display 
categories. 
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To the right is the display window area used to 
provide the display category detailed informa- 
tion. The current selected category title replaces 
the MacSleuth window title at the top. Initially, 
the MacSleuth logo appears in the display area 
with the MacSleuth title. ) 


OSs === mMacSleuth - Initialization Procedures 
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Once a display category is active and is being 
viewed, you may still move the elevator to 


another display category without affecting the 


display window. Only when you double-click on 
a display icon does a new display category get 
selected, causing the display window to change. 


MacSleuth User’s Manual - 3 


©.0,0,0.0.0.0.0.0,0,0.9.0.0.0,0.9.0.0,0,0.0,0,0,9,9,0,0,0,0,0,0.0,0,0,0,0,0.9,0,0.0.0,9,0,0,0.0,0,0,0,0,0.0.0.9.9,0,0,0,0, 08.0, 


The display window area is clearly insufficent 
for many categories displaying large amounts of 
detailed information. A key component of the 
MacSleuth interface is the ability to view a mullti- 
tude of display windows for a particular module 
under your total control. This is accomplished 
by highlighting a display category as indicated by 
the following example: 


In this example, the user has selected the In- 
itialization Procedures display category and has 
been presented with a full display window. Note 
the reversed display icon and its title. The user 
has the following options at this point: 


Click on the reversed display icon ( not the title 
) to view the next display page. 


_ Click anywhere else to terminate the display 
category and perform some other function. 


Note: a Double-Click is not required. If you 
click the mouse button anywhere else but on the 
display icon, the display category will be ter- 
minated. 

Menu Selections 


The MacSleuth menu is as follows: 


File Edit Help 
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About MacSleuth shows information about the 
current release of MacSleuth. 


Under File there are three active choices. The 
Report selection allows you to send a printed 
copy of each display window to the printer of 
your choice on a module-by-module basis. Refer 
to the section below on Generating MacSleuth 
Reports. Page Setup displays a standard Macin- 
tosh Print dialog to allow the setting of page op- 
tions. Refer to your supplied Macintosh 
documentation for page setup details. The Quit 
selection exits the MacSleuth application. You 
may also exit by double-clicking on the go-away 
box in the upper left corner of your MacSleuth 
window. 


General Information 
Nerdwore Summery 
Startup Information 


initialization Procedure: 
Parameter Sattiangs 


insteiied Devices 
Choeser Devices 


The Edit selection currently has no active 
entries. 


Under Help there are two choices. The Current 
Selection Display provides information on how 
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to interpret the the information in the current 
display window for the currently selected display 
category. The Using MacSleuth selection 
provides a brief summary of the information in 
this section of the manual. Refer to the section 
below on Using MacSleuth Help for more 
details. 


+"0'0"0"0"0'0'0'0"0'0'0'0"0"0'0"0"0'0'#"'0'8'0"0"0'0'0'0'0'0'2 6 0'0'0'0'0'0"0"0"0'0'2'0"0'0'0'0'0"0"0'0"0"0'0"0'0'0'0'0'0'0'0'0'0'0"0'0'O'0"0°0'0'0'0'0'0 B 0'0'0'0'0'0"0''8'0'0'0'0' 0" 


When the Report option is selected, the follow- 
ing dialog is displayed: 


You may select one or more display categories 
using the standard Macintosh List selection 
guidelines. Clicking on any entry with the mouse 
will cause it to be included in the print report. 
Depressing the key while selecting allows more 
than one category to be included. Using the Shift 
key allows selection of a group of display 
categories. 


Once you have selected your categories, select 
Print to cause the detailed information to be 
printed, or Cancel to abort the Report. Selecting 
Print will cause a standard Apple Print Job 
dialog to be displayed to allow setting of a num- 
ber of print options. Refer to your supplied 
Macintosh documentation for print job details. 
MacSleuth currently ignores the page range 
parameters, but will produce the indicated num- 
ber of report copies. 


The format of a printed report consists of a 
header line followed by the same graphics and 
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textual information that would appear in the dis- 
play window if you manualy selected the display 
categories in sequence: 


*ex%e% ViacSleuth - Hardware Information Page 1 ****** 
[ Display Information, page 1.... ] 


*kket* ViacSleuth - Hardware Information Page 2 ****** 


[ Display Information, page 2 .... ] 


During report generation, you may terminate 
the report at any time by simultaneuously hitting 
the ™ and "." keys 
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Help on using MacSleuth in general or concern- 
ing the currently selected display category are 
both handled by the following modal help win- 
dow: 


The help window contains the display category 
title followed by one or more pages of detailed 
information designed to help you interpret the 
category you have selected. You may at this 
point move forward or backward in the display 
one or more pages by using the elevator on the 
right. To return to normal MacSleuth operation, 
click on the Cancel button. 
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The display categories active with this release of 
MacSleuth are outlined below along with a brief 
description of the category usage. Please note: 
more detailed information about a category and 
the underlying concepts can be viewed by activat- 
ing the on-line MacSleuth Help while the 
category is actively displayed. 


You should note that as you explore your system 
using MacSleuth, a particular concept may show 
up in several different categories. If you have a 
card in a NuBus slot, for example, it will be iden- 
tified directly by the Hardware Summary, its 
driver will be listed in the Installed Devices dis- 
play, any supporting timer queue handler will 
show up in the Interrupt Queue display, etc... 


Notation 


MacSleuth uses the following display conven- 
tions and abbreviations: 


MB 
Megabyte. 1.2 MB is 1,200,000 
$XXXXXX 


A machine address. $E08040 = main screen ad- 
dress. 
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DPI 

Dots per inch. 72x72 DPI screen eau an 
HZ 

Frequency in cycles/second. 60Hz clock 
Ticks 


Number of 60 Hz clock ticks. 20 Ticks. 
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The display window provides a summary of the 
major features of your Macintosh computer sys- 
tem, including your processor type, ROM and 
RAM memory sizes, disk types, card slots, key- 
board, sound, display characteristics, etc.. 


This display is merely an introduction to your 


Macintosh. Many of these features are explored 
in subsequent display categories in more detail. 
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Hardware Information 
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This display highlights the individual hardware 
components of your MacIntosh, such as: 


— Video Interface 

— Sound subsystem 

— Floppy Disk Interface 
— $§CSI Interface 

— Apple Desktop Bus 


— Nubus Slots 
The multi-window display will be activated at 


the end of each section to allow you to page 
through the various display pages. 
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This display identifies the startup information 
defined when your Macintosh system is booted. 
The information includes: 


— Boot Volume directory and version number 

— System, Finder and Debugger file names 

— Startup Screen and Application file names 

— Operating System File and Event buffering limits 


— System zone sizes 
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Initialization Procedures — 


-e"e“ovoToTe“e"eTeTovove"evoTeTovoTeveTevevereveTevTetevoveveTevecotovoveTeevetoreTeTerereloreveTeTerereroTeTevoverovoreTeneverovereTeTevelereleleve’elerererevererererereTererereve“ee"ererereneTe"e"e7ere"eTeTe’e"e"e7e7e"ee"e"6) 
SSeS RCM HI HO MO IC I RM SO ID 
COPED BEDE DS DDE BED DPD DB DPBS DO DP DBS DD PD OE DED PPS PP PP DAD aD ie ir at i ah hd at ad dO Oe he he 


This display lists all active or inactive proce- 
dures that are automatically initiated when your 
machine is booted. These procedures fall into 
three categories: 


Control Panel Procedures 


These routines initialize conditions for the 
operation of your Control Panel Desk Accessory. 


Chooser Devices 


These routines support operations associated 
with the Chooser Desk Accessory, such as start- 
ing up your AppleShare file server application. 


Startup Utilities 


These routines are more general utilities that 
have been inserted in your System Folder as 
INIT resources, usually as a result of installing 
various applications needing initialization at 
boot time. 


The information displayed for each startup 
utility includes: 


— The utility name 


— The number of individual procedures executed within 
the utility code 


— The amount of system heap space needed 
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A starup utility can become inactive if disabled 
by one of the popular Control Panel manipula- 
tion utilities, such Aaskt ( MockPackage Plus 
Utilities). A disabled utility appears crossed out 
with a large "X". 
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This display shows the current settings for the in- 
formation stored in your permanent Parameter 
RAM. Many of these parameters are main- 
tained by your Control Panel Desk Accessory. 
The parameters include: 


— System Startup Disk 

— Menu and Caret blinking thresholds 
— Modem and Printer port parameters 
— Current application font 


— AppleTalk Network parameters 
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This display identifies all nodes currently con- 
nected to your AppleTalk network. The name, 
type, and zone id for each named entity is dis- 
played. 


The network nodes are typically either File Ser- 
vers for accessing a remote file system, or Printer 
Servers for handling your requests to a shared 
printer device. 
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This display provides information for each 
mounted volume attached to your MacIntosh sys- 
tem. A volume is identified as either Flat (con- 
taining no directories) or Hierarchical 
(containing directories and possibly subdirec- 
tories). 


The volume statistics displayed include capacity, 
free and used space, directory and file counts, 
creation and modification dates, and associated 
driver information. 
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Installed Devices  — 
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This display describes the drivers which are cur- 
rently installed in your machine. Up to 128 
drivers may be active at any time. The informa- 
tion displayed includes: 


— Driver unit number 
— Driver name 


— Driver type: ROM/RAM, SCSI or Slot, regular driver or 
Desk Acessory 


— Driver status ( open or closed) 


— Driver slot and id if controlling an Apple or user Nubus 
slot 
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This display describes all devices under the con- 
trol of the Chooser Desk Accessory. Examples | 
of such devices are the AppleShare File Server 
and your various local and shared printers, such 
as all accessible Imagewriter and Laserwriter 
devices. The device and version ID’s are dis- 
playedalong with various flags for each entry. 
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The display shows all of the Desk Accessories 
currently installed on your system. The informa- 
tion displayed includes: 


— The accessory name 
— Status (active now or inactive ) 


— The eventmask defining the system/user events hand- 
led by the accessory 


- Any clock tick count response data Various attribute 
flags 
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This display lists all installed activities under the 
control of the Control Panel Desk Acessory. 
Those that are currently marked as inactive are 
crossed out with a large "X". A Control Panel ac- 
tivity can become inactive if its corresponding 
startup utility has been disabled ( refer to the In- 
itialization Procedures section above). 
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This display shows all the the entries present in 
the various active operating system queues. The 
queue types and the corresponding information 
displayed are as follows: 


Vertical Retrace Queue 


The tasks assigned to the vertical retrace inter- 
rupt (VBL) are displayed as to task address, fre- 
quency of response in ticks, and phasing 
information. 


Deferred Tasks 


These are similar tasks requiring periodic ac- 
tion, but only after other more critical tasks have 
been executed. The information displayed in- 
cludes the task address, flags, and an optional 
parameter passed to the task. 


Slot Device Interrupt Tasks 


These tasks handle interrupts for device hand- 
lers controlling Apple and Nubus slots. The infor- 
mation displayed includes the slot number begin 
handled, the task address, the task priority, and 
an optional parameter passed to the task. 
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This display allows you to list and view the 
various resources available on your Macintosh 
system. Various resource usage statistics are 
computed and displayed, such as the number of 
open resource files, distinct resource types, etc.. 


You may then select from popup menus a 
variety of List and View activities. List activities 
include listing all active resources, all open 
resources, or only those ROM resources which 
have been overriden as part of the startup boot 
process. 


Selected classes of resources are available for 
Viewing, such as Fonts, Icons, and Pictures. 
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Memory informat 
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This display provides information about your 
system memory uSage. Statistics are presented 
that define the system and Application zones, 
current stack size, total free space and largest 
free block. 


The next display section presents some of the 
more interesting system globals and their current 
values, including the ROM, RAM, and screen 
memory base addresses, the system and applica- 
tion zone bases and the memory top and heap 
end values. 
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